Xbasic

A5_WildcardSelect Function

Syntax

List as C = A5_WildcardSelect(C choices ,C existingChoices [,C dialog_title [,C Caption ]])

Arguments

List

The final selected list.

choices

The search string to use. A search string may contain characters and wildcard characters. The "?" character substitutes for any single character. The "*" character substitutes for any series of characters.

existingChoices

A CR-LF delimited list of values.

dialog_title

Optional. Default = "Wildcard Select"

Caption

Optional. Default = "Matching tables".

Description

Used to do a wildcard selection in a list or checkbox.

Discussion

The A5_WildcardSelect() function displays a dialog that accepts arguments and calls FILTER_STRING_SMATCH().

Example

This example initializes the list with "Red" and "Blue". After entering "g*", selecting Add to Existing Selections, and clicking OK, the function returns the initial colors plus all the color names beginning with "g".

dim list as C
dim existing as C
list = a5.Color_Enum()
existing = "Red" + crlf() + "Blue"
? A5_WildcardSelect(list, existing, "Find Color", "Color Name")
= Red
Blue
Gold
Gray-80
Gray-50
Gray-40
Gray-25
Green White

Limitations

Desktop applications only.

See Also